home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / games2 / rotise12.zip / ROTISE.DOC < prev    next >
Text File  |  1993-03-28  |  11KB  |  379 lines

  1.                                     ROTISE
  2.        ================================================================
  3.  
  4.   ROTISE is a program will help you  run your rotisserie league.  It is to  be 
  5. used by the league  secretary,  and  requires  the  weekly  downloading  of  a 
  6. statistics file from some  source  (some  are  mentioned  below).   After  the 
  7. secretary enters all the  weeks  transactions,  ROTISE  is  run  against  this 
  8. transaction file' and produces a  report  on  all  the  teams  and  shows  the 
  9. standings.
  10.  
  11.   ROTISE is  available with  complete source  code and  is free  to use.   The 
  12. authors  of  ROTISE,  Jonathan  Arnold  and  Mark  Mallett,  can  be   reached 
  13. electronically in a variety  of ways.  Both can  be reached via the  Internet.  
  14. Jon's email address is  jdarnold@world.std.com, while Mark  can be reached  at 
  15. mem@mv.mv.com.  Also, Jon frequents the  RIME network, and  can be reached  by 
  16. routing a message to BASEBALL,  sent to  'Jonathan Arnold'.   Also, they  both 
  17. inhabit Jonathan's BBS, called The Complete Sports BBS.  The main number there 
  18. is (617)335-2238.  We encourage catcalls,  comments and criticisms, as we  are 
  19. always looking to improve ROTISE.
  20.  
  21.   Statistics files  can be  found on  a number  of BBS',  including the  above 
  22. mentioned Complete Sports BBS.  The USA Today SportsCenter BBS is also a  good 
  23. source for stat files.
  24.  
  25. Files
  26.  
  27.   Inforoto.91     - Sample command file
  28.   Makefile.Bcc    - makefile for Borland/Turbo C
  29.   *       .H      - Include files
  30.   *       .C      - Source files
  31.   Rotise  .Doc    - This file
  32.   Rotise  .Exe    - IBM PC executable
  33.   Makefile.Msc    - makefile for Microsoft C
  34.   Rotise  .Lnk    - MSC linker file
  35.  
  36.  
  37. ROTISE command line options
  38.  
  39.  Here is how you run ROTISE:
  40.  
  41.  rotise [options] command-file [command-file...]
  42.  
  43.  Possible options include:
  44.    -i : Use IBM graphics characters when printing reports
  45.    -ffname : Generate a freelist, putting it in file 'fname'
  46.    -V : Print ROTISE version string
  47.    -sfname : Generate a worksheet file in 'fname'
  48.    -v[0-4] : verbose option.  Higher numer means more talking
  49.    -wn : init database to 'n' weeks.  Higher number uses more memory.  The 
  50.          default is 30.
  51.  
  52.  Then pass it the command file (or files) to use.  The complete description 
  53. for the command file is below.  ROTISE prints the report to the screen.  Use 
  54. redirection to put it either in a file or dumped directly to the printer, like 
  55. thus:  rotise command-file >report.txt.  
  56.  
  57.  
  58. ROTISE Command File
  59.  
  60. Terms and abbreviations used in this section:
  61.  
  62.     RT    A short, unique abbreviation for a Rotisserie team.
  63.         When you define the league, you assign these
  64.         abbreviations for easy reference to each team.  Each
  65.         abbreviation is unique and represents a specific team.
  66.         
  67.     PK    Unique name of a player, as found in the data file.
  68.         (We use the data from USA Today's electronic
  69.         service.)  This is usually a {last name, first
  70.         initial} pair.  Sometimes the first initial is not
  71.         representative, but assigned to make the entire name
  72.         unique.  Sometimes the first initial is missing
  73.         altogether, in which case you should probably edit the
  74.         data file and supply one yourself.  (If you don't
  75.         supply one, the routine that parses the input data
  76.         will default a "." for the first initial -- and you must
  77.         reference the player with this first initial.
  78.  
  79.  
  80.  
  81.   The transaction-oriented command file is a sequence of command lines.   Each 
  82. line starts with a command  token  specifying  some  sort  of  transaction  or 
  83. definition or general action to perform.   This command token may be  followed 
  84. by arguments as required by the individual command.  
  85.  
  86.   Following is a description of  the various command  tokens.  Those that  are 
  87. marked with an "*" are currently not implemented.  Those marked with a "#" are 
  88. things being considered to make  the program more  flexible but are  currently 
  89. hardcoded.  For more  information,  please  see  the  included  command  file, 
  90. 'inforoto.91'.  This is the actual file used by our league in a recent season.  
  91.  
  92.  Secretarial transactions:
  93.  
  94. ;
  95.   Either indicate comment line
  96.  
  97.  
  98. =[=..] date filename [pfilename]
  99.  
  100.         date - in the form monthnum/daynum (i.e., 7/14 for July 14)
  101.         filename - Name of stat data file
  102.         pfilename - optional; name of positional data file
  103.  
  104.   New interval is started.  Can have as many '='s as you want.
  105.  
  106.  
  107.  
  108. oposf filename
  109.  
  110.         filename - name of file with data in it
  111.  
  112.   This is the data file with the previous year's positional data
  113.  
  114.  
  115.  
  116. slot Slot postions
  117.  
  118.         Slot - 1-3 letter, unique, slot name
  119.         postions - list of positions that qualify for this slot.  
  120.                            Separate them with spaces or commas
  121.  
  122.   As many of these as are players on a roster.  Give each slot a
  123.   unique, 1-3 name, and the list of positions which are qualified for
  124.   it.  Official Rotisserie slots are:
  125.  
  126.     C1, C2, 1B, 2B, SS, 3B, 13, 2S, DH or UT, OF1, OF1, OF2, OF3, OF4, OF5,
  127.        and P1 - P9
  128.  
  129.  
  130.  
  131. bstats [stat-list] #
  132.  
  133.         stat-list - list of stats to be used for ranking
  134.           batters.  Seperate each with a space.
  135.  
  136.  Tell which stats will be used for batters.  The list can be any or all
  137.  of:
  138.  
  139.      1B, 2B, 3B, HR, RBI, AVG, SB, CS, ERR, R, SO
  140.  
  141.  The defaults are: HR, RBI, AVG, and SB
  142.  
  143.  
  144.  
  145. pstats [stat-list] #
  146.  
  147.         stat-list - list of stats to be used for ranking
  148.           pitchers.  Seperate each with a space.
  149.  
  150.  Tell which stats will be used for pitchers.  The list can be any or all
  151.  of:
  152.      W, L, PCT, CG, SHO, S, SO, BB, ERA, ER, IP, H, HR, RATIO (i.e.,
  153.     (H+BB)/IP)
  154.  
  155.  The defaults are: W, S, ERA, and Ratio
  156.  
  157.  
  158.  
  159. Cost specification commands:
  160.  
  161. $ Category Amount #
  162.  
  163.         Category - one of the following keywords (or unique
  164.         abbreviation):
  165.  
  166.             release - cost of releasing a player (Default: 0)
  167.           claim - claim player from free agent list (Default: 25)
  168.           reserve - place player on reserve list (Def: 10)
  169.           expand - claim player for Sept. roster expansion (Def: 50)
  170.           freesal - claimed free agent salary (Def: 10)
  171.           expsal - Expansion player salary (Def: 25)
  172.           waiverclaim - claiming a player off waiver wire (Def: 10)
  173.           activate - activate a player from reserve (Def: 10)
  174.           farm - cost of player starting season in minors (Def: 10)
  175.  
  176.         Amount - cost in salary units
  177.  
  178. Describe how much each transactions costs, in salary units.
  179.  
  180.  
  181.  
  182. salunit Pennies #
  183.  
  184.         Pennies - how many pennies in each salary unit
  185.  
  186.  For formatting purposes, how many pennies make up each salary unit.
  187.  
  188.  
  189.  
  190.     
  191. Real Player stuff
  192.      
  193. hide PK
  194.  
  195.     PK - Player's keyword
  196.  
  197.  Hide a player on the free agent list.  Used to remove players who have
  198.  been traded to the other league or retired, or for whatever reason you
  199.  might want to remove the name from the available free agent list.  
  200.  
  201.  
  202.  
  203. status PK [StatWord [date]]
  204.  
  205.      PK - Player's keyword
  206.     StatWord - Any 1-4 letter keyword denoting special status
  207.     date - effective date, in the formate month/day (i.e., 7/14)
  208.  
  209.  Assign a status to any player.  This can be used to indicate going on
  210.  the disabled list, sent down to the minors, etc.  If used without a
  211.  statword, then any previous status is cleared.  If this player is on
  212.  a RT's reserve list or in the minors, player is put on possible
  213.  waiver list, to begin in two weeks.  The statword will be printed on
  214.  the stat sheet, along with the date, if any given.  If no date, then
  215.  the date of the interval is used.  Suggested words:
  216.  
  217.     15DL - 15 day disabled list
  218.     30DL - 30 day disabled list
  219.     60DL - 60 day disabled list
  220.     MIN  - Sent to minors
  221.     REL  - unconditional release
  222.     OL   - sent to "other" league
  223.     SUSP - suspended
  224.     RETR - retired
  225.  
  226.  
  227. Preseason Rotisserie Team activities:
  228.  
  229. league fullname
  230.  
  231.         Fullname - Name and description of league
  232.  
  233.   Give the league a name and description.  Can be up to 80 characters
  234.   long.
  235.  
  236.  
  237.  
  238.     
  239. team RT fullname
  240.  
  241.           RT - Rotisserie Team keyword (must be unique and one word)
  242.         fullname - rest of the line is the full name of the team
  243.  
  244.   Name the teams in the league.  There can be up to 15 teams in a league.  The 
  245. first 25 characters are used in reports.
  246.  
  247.  
  248.  
  249. owner RT OwnerName
  250.  
  251.           RT - Rotisserie Team keyword (must be unique and one word)
  252.         OwnerName - rest of the line is the full name of the owner(s)
  253.  
  254. Assign a name to the owners of the team.  Should be one of these commands per 
  255. team.
  256.  
  257.  
  258.  
  259.  
  260. add RT PK Slot Salary Contract Full-name
  261.  
  262.           RT - Rotisserie Team Keyword
  263.           PK - Player's keyword
  264.           Slot - Rotisserie Team slot to go into
  265.           Salary - # of salary units
  266.           Contract - Contract keyword.  1 letter keyword of:
  267.             A - first year
  268.             B - Second year
  269.             O - Option year
  270.             1-9 - # years remaining before option year
  271.           Full-name - Rest of line is the full name of the player
  272.  
  273.  Add player to the roster before the season has started.
  274.  
  275.  
  276.  
  277. minors RT PK [Fullname] *
  278.  
  279.         RT - Rotisserie Team keyword
  280.         PK - player keyword
  281.         Fullname - optional complete name
  282.  
  283.  Add player to team's minor league list
  284.   
  285.  
  286.  
  287. Rotisserie Team activities:
  288.  
  289.  
  290. move RT PK Slot
  291.  
  292.           RT - Rotisserie Team keyword
  293.           PK - Player's Keyword
  294.           Slot - new slot to fill
  295.  
  296.  Move player from current slot to new slot on roster
  297.  
  298.  
  299.  
  300. release RT PK [W]
  301.  
  302.           RT - Rotisserie Team keyword
  303.           PK - Player keyword
  304.         W - anything; indicates player is waived
  305.  
  306.  Release player from roster (ie., add to free agent pool).  If W is
  307.  non-blank, then the player is added to the waiver list for the next
  308.  two weeks.
  309.  
  310.  
  311.  
  312.  
  313. claim RT PK Slot [Full-name]
  314.  
  315.           RT - Rotisserie Team keyword
  316.           PK - Player keyword
  317.           Slot - slot to fill in RT
  318.           Full-name - optional full name of player.
  319.  
  320.  Claim player from free agent pool.  If player is on active waiver
  321.  wire, then do a waiver transaction, otherwise just claim from free
  322.  agents.
  323.  
  324.  
  325.  
  326. reserve RT PK 
  327.  
  328.           RT - Rotisserie Team keyword
  329.           PK - Player keyword
  330.  
  331.  Add player to teams reserve list
  332.  
  333.  
  334.  
  335. activate RT PK  [Slot] 
  336.  
  337.           RT - Rotisserie Team keyword
  338.           PK - Player keyword
  339.         Slot - slot to move player into
  340.  
  341.  Activate a player from the team's reserve or minor league list.  If
  342.  not slot is passed, then activate player into the slot he is tied to
  343.  (assumes player had been reserved earlier).
  344.  
  345.  
  346.     
  347. trade RT PK newRT cost *
  348.  
  349.         RT - Rotisserie Team keyword
  350.         PK - player keyword
  351.         newRT - new team's keyword
  352.         cost - cost to RT, in salary units
  353.  
  354.  Trade a player from RT to newRT.  The cost is listed here as often one
  355.  team will pick up the entire cost of the transaction, rather than the
  356.  normal 5 salary units per RT.
  357.  
  358.  
  359.  
  360.  
  361. expand RT PK p|h
  362.  
  363.         RT - Rotisserie Team keyword
  364.         PK - player keyword
  365.         p|h - p= Pitcher, h= hitter (one or the other, please)
  366.  
  367.  September Roster expansion player
  368.  
  369.  
  370.  
  371. create PK position
  372.         PK - player keyword
  373.                 postition - Eligible position
  374.  
  375.  Create a player who is not in the database yet.  Use this command to add a 
  376. player involved in a transaction before he is actually read into the database. 
  377.  
  378.